package com.example.forum.services;

import com.example.forum.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * @author hanzishuai
 * @date 2025/4/9 21:05
 * @Description
 */
public interface IArticleService {

    /**
     * @param article 要发表的帖子
     * @Description 发布帖子
     */
    @Transactional
    void create(Article article);

    /**
     * @return java.util.List<com.example.forum.model.Article>
     * @Description 查询所有的帖子列表
     */
    List<Article> selectAll();


    /**
     * @param boardId 板块 Id
     * @return java.util.List<com.example.forum.model.Article>
     * @Description 根据板块 Id 查询帖子列表
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * Created by hanzishuai on 2025/4/10
     *
     * @param id 帖子 Id
     * @return com.example.forum.model.Article
     * @Description 根据帖子 Id 查询帖子详情
     */
    Article selectDetailById(Long id);


    /**
     * Created by hanzishuai on 2025/4/11
     *
     * @param id 帖子 Id
     * @return com.example.forum.model.Article
     * @Description 根据帖子 Id 查询帖子
     */
    Article selectById(Long id);

    /**
     * Created by hanzishuai on 2025/4/12
     *
     * @param userId 用户 Id
     * @return java.util.List<com.example.forum.model.Article>
     * @Description 根据用户 Id 查询帖子列表
     */
    List<Article> selectByUserId(Long userId);


    /**
     * Created by hanzishuai on 2025/4/11
     *
     * @param id      帖子 Id
     * @param title   帖子标题
     * @param content 帖子内容
     * @return void
     * @Description 根据帖子 Id 更新帖子内容
     */
    void modify(Long id, String title, String content);


    /**
     * Created by hanzishuai on 2025/4/12
     *
     * @param id 帖子 Id
     * @return void
     * @Description 点赞帖子
     */
    void thumbsUpById(Long id);


    /**
     * Created by hanzishuai on 2025/4/12
     *
     * @param id 帖子 Id
     * @return void
     * @Description 根据 Id 删除帖子
     */
    @Transactional
    void deleteById(Long id);

    /**
     * Created by hanzishuai on 2025/4/12
     *
     * @param id 帖子 Id
     * @Description 文章回复数 + 1
     */
    void addOneReplyCountById(Long id);

    /**
     * Created by hanzishuai on 2025/4/12
     *
     * @param id 帖子 Id
     * @Description 文章回复数 - 1
     */
    void subOneReplyCountById(Long id);


    /**
     * Created by hanzishuai on 2025/5/6
     *
     * @param content 要查询的标题内容
     * @return com.example.forum.common.AppResult<java.util.List < com.example.forum.model.Article>>
     * @Description 根据 content 返回帖子列表
     */
    List<Article> search(String content);


    /**
     * Created by hanzishuai on 2025/5/13
     * @param article  要更新成的帖子对象
     * @Description  更新帖子对象（不包含 content）
     */
    void updateByPrimaryKeySelective(Article article);

}















